home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / disk / fill704.zip / FILL.DOC < prev    next >
Text File  |  1997-04-28  |  23KB  |  465 lines
  1. FILL.DOC                               1                           Apr 28, 1997
  2.  
  3. The FILL program is designed to help you move or copy files  off  a  hard  disk
  4. while reducing the amount of wasted space on the destination disks. Internally,
  5. it does this by sorting the file names so the largest  files  are  moved/copied
  6. first.  It then moves or copies whatever files can fit on the floppy,  skipping
  7. any that can't.  Features:
  8.  
  9.   * Can either move or copy the files to the resulting location.
  10.   * Defaults to moving files if parameters passed in; prompts otherwise.
  11.   * Can continue to multiple diskettes as desired, beeping if desired when  the
  12.     next disk is expected.
  13.   * Can move the files in file name order or  in  any  of  the  other  standard
  14.     ordering sequences.
  15.   * Can be used to split up files which are too big to fit on a single disk.
  16.   * Works fine for network transfers where standard MOVE command doesn't always
  17.     work.
  18.   * Works fine on Iomega ZIP drives and other  DOS-level  compatible  removable
  19.     media.
  20.   * Can create a status/transaction file, showing what was copied/moved.
  21.   * Can label the output diskette, providing some patterns like  disk  sequence
  22.     numbers and dates which it will fill in for you.
  23.   * Can review and delete if desired any files which are already in the  output
  24.     destination (for example, already on the output diskette).
  25.   * Can reformat the whole disk if files are going to drive A or B.
  26.   * Can specify an input file ("@listfile") which  contains  the  files  to  be
  27.     copied.
  28.   * The date format shown in reports is based on your country setting.
  29.   * Pressing escape stops the program early.
  30.  
  31. Limits:
  32.   * Routine can only process the first 500 files found.  It ignores the rest of
  33.     them.  If you're using /MOVE, you can always run it after some of the files
  34.     are gone and get the rest of them that way.
  35.   * Routine can only review for deletion the first  200  files  in  the  output
  36.     location.
  37.   * Routine does not provide any cool features to  fix  up  destination  drives
  38.     that have surface errors.  If it encounters an error, it just beeps,  gives
  39.     you an error message, and returns to DOS.
  40.   * Routine will not format the output diskette for you.
  41.   * Switching diskette densities is not recommended (for  example,  intermixing
  42.     720K diskettes with 1.44MB diskettes may cause errors).
  43.  
  44.  
  45.  
  46. FILL.DOC                               2                           Apr 28, 1997
  47.  
  48. Note on copying/moving files to multiple diskettes:
  49.  
  50. I didn't think this was confusing but a lot of people don't seem to  understand
  51. the technique of how files are moved to multiple diskettes.
  52.  
  53. Let's say you have six files:
  54.  
  55.         A_FILE.ZIP      500K
  56.         B_FILE.ZIP      300K
  57.         C_FILE.ZIP      650K
  58.         D_FILE.ZIP      200K
  59.         E_FILE.ZIP      450K
  60.         F_FILE.ZIP       25K
  61.  
  62. You're moving these files to blank 1.2MB diskettes and  you  have  the  default
  63. /MULTI and /ON settings.  The program checks how much space is available on the
  64. destination drive and comes back with 1.2MB.
  65.  
  66. It scans the input files and internally sorts them by descending size.  It then
  67. looks for the biggest file in the file list and comes back with  C_FILE.ZIP  at
  68. 650K.  Will this file fit on the destination  drive?   Yes.   It  retains  that
  69. information, figures there is now 550K left on the output drive, and checks for
  70. the second biggest file.  A_FILE.ZIP is 500K.  Will that also  fit?   Yes.   So
  71. now there's 50K left.  The next biggest file is E_FILE.ZIP at 450K.  Will  that
  72. fit?  Nope.  Check the next biggest.  This continues until it reaches the  file
  73. F_FILE.ZIP which is only 25K.  That's the biggest file that  will  fit  in  the
  74. remaining 50K.
  75.  
  76. So it has three files to move.  What order should it move them?  You  have  /ON
  77. set so it's going to move them in file name order.  So it moves  the  following
  78. files in the following order:
  79.  
  80.         A_FILE.ZIP      500K
  81.         C_FILE.ZIP      650K
  82.         F_FILE.ZIP       25K
  83.  
  84. Next diskette.  Same process.  This time it processes the remaining files:
  85.  
  86.         B_FILE.ZIP      300K
  87.         D_FILE.ZIP      200K
  88.         E_FILE.ZIP      450K
  89.  
  90.  
  91. Specifying parameters:
  92.  
  93. Parameters for this program can be set in the following ways.  The last setting
  94. encountered always wins:
  95.   - Read from an *.INI file (see BRUCEINI.DOC file),
  96.   - Through the use of an environmental variable (SET FILL=whatever), or
  97.   - From the command line (see "Syntax" below)
  98.  
  99.  
  100.  
  101. FILL.DOC                               3                           Apr 28, 1997
  102.  
  103. Syntax:
  104.  
  105.     FILL [ filespec | (filelist) | @listfile ] [ pathspec | /TO pathspec ]
  106.       [ /MOVE | /COPY ] [ /PROMPT ] [ /Ox | /O-x ]
  107.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  108.       [ /Xfilespec ]... [ /ATTR=attribs ] [ /WIPE ] [ /MULTI | /SINGLE ]
  109.       [ /SPLIT ] [ /FORCE ] [ /-LETTER ] [ /LABEL=label [ /START=n ] ]
  110.       [ /Frptfile [ /S+ | /S- | S* ] [ /CONT ] [ /TIME ] [ /-BEEP ] [ /Q ]
  111.       [ /-LAST ] [ /FAKE ] [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ]
  112.  
  113. where:
  114.  
  115. "filespec" is the file specification for  what  you  want  to  move.   You  can
  116. specify a drive  and  path  and  file  wildcards  if  necessary  (for  example,
  117. "C:\TEMP\*.BAT") but otherwise it defaults to your default drive and  directory
  118. and takes "*.*".  Note that the program cannot handle any request for more than
  119. 500 files at a time.
  120.  
  121. "(filelist)" allows you to specify multiple files  to  be  processed  from  the
  122. command line.  File names should be separated  by  spaces.   They  may  include
  123. drive, path, and wildcard information.  Remember that a  command  line  in  DOS
  124. cannot exceed 127 characters so you're limited as to how  many  different  file
  125. specifications you can provide in this fashion.
  126.  
  127. "@listfile" allows you to have a variety of file specifications saved in a text
  128. file named "listfile".  You cannot have more than  50  file  specifications  in
  129. this file (and you're still limited to the 500 files total).  Each line  should
  130. consist of a file name with optional drive and path information.   Blank  lines
  131. and lines beginning with semi-colons, colons, or quotes are ignored.
  132.  
  133. "pathspec" (or "/TO pathspec") tells the routine what drive or path to move the
  134. files to.  The use of the "/TO" keyword is optional unless the specification is
  135. being provided in an initfile.  The initial default is "A:" (or "/TO A:"). (Use
  136. the initfile--see BRUCEINI.DOC--if you need will usually need to change it "/TO
  137. B:" or something.)
  138.  
  139. In many cases, the routine doesn't really care whether the source specification
  140. precedes  or  follows  the  destination  specification.   If  either  parameter
  141. contains a wildcard or a period, FILL presumes that's the source  specification
  142. and the other one must be the destination specification.  If only one parameter
  143. is specified, FILL  usually  presumes  that's  the  destination  specification.
  144. Quickie table:
  145.  
  146.         User passes      Presumed   Presumed
  147.                          filespec   pathspec
  148.  
  149.         FILL C:          *.*        C:
  150.         FILL C: A:       C:*.*      A:
  151.         FILL *.BAS A:    *.BAS      A:
  152.         FILL *.BAS       *.BAS      A:
  153.         FILL C: /TO A:   C:*.*      A:
  154.         FILL /TO B:      *.*        B:
  155.         FILL             *.*        A:
  156.  
  157.  
  158. FILL.DOC                               4                           Apr 28, 1997
  159.  
  160. "/MOVE" says to move the files instead of copying them.  Initially defaults  to
  161. "/MOVE" if other parameters are passed in (for example, "FILL *.ZIP" will  move
  162. the files) and prompts otherwise.  Check out BRUCEINI.DOC  for  information  on
  163. changing the defaults otherwise.
  164.  
  165. "/COPY" says to copy the files instead of moving them.  Initially  defaults  to
  166. "/MOVE" if other parameters are passed in (for example, "FILL *.ZIP" will  move
  167. the files) and prompts otherwise.
  168.  
  169. "/PROMPT" says to  prompt  for  each  filename  before  moving  it.   Initially
  170. defaults to "/-PROMPT".
  171.  
  172. "/-PROMPT" says to not prompt for each file.  Initially defaults to "/-PROMPT".
  173.  
  174. "/Ox" and "/O-x" allow you to specify the copy order for the files.  "x" can be
  175. one of the following:
  176.  
  177.         N = file name
  178.         D = file date and time
  179.         S = file size
  180.  
  181. If you precede the "x" with a dash ("-"), the sort  will  be  done  in  reverse
  182. order.  Note that this parameter does not determine which files are copied;  it
  183. only determines what order they are actually copied.  Since the order that  the
  184. file tends to show up in a DOS DIR listing is based  on  creation  order,  this
  185. sequence may be relevant to  how  the  files  ultimately  show  up.   Initially
  186. defaults to "/ON".
  187.  
  188. "/OVERWRITE" says to  overwrite  same-named  files  in  the  destination  path.
  189. Initially defaults to "/OVERSKIP".
  190.  
  191. "/-OVERWRITE"  says  to  abort  if  any  same-named  files  are  found  in  the
  192. destination path.  Initially defaults to "/OVERSKIP".
  193.  
  194. "/OVERSKIP" says to skip any file that already exists in the destination  path.
  195. The counts aren't accurate in this case.  This is initially the default.
  196.  
  197. "/OVERASK" says  to  prompt  if  same-named  files  exist  in  the  destination
  198. directory.  Initially defaults to "/OVERSKIP".
  199.  
  200. "/Xfilespec" says to exclude certain  filespecs  from  being  moved.   You  can
  201. specify up to 10 exclusion parameters but each must have their  own  /Xfilespec
  202. statement.  For example, to move all files except those with a  BAS  extension,
  203. you could say "FILL /X*.BAS".
  204.  
  205. "/ATTR=attribs" allows you to specify a combination of attributes that you want
  206. considered.  You can specify any combination of R (read-only),  H  (hidden),  S
  207. (system), or A (archive bit).  Precede any character(s)  with  "-"  to  exclude
  208. instead of include.  Unlike with  the  DOS  DIR  command,  the  inclusions  and
  209. exclusions are subject to "OR" conditions; /ATTR=HS will retrieve any file that
  210. is either hidden or a system file or both.   You  can  specify  "/ATTR=ALL"  to
  211. specify that all files are to be processed.  Initially defaults  to  /ATTR=-H-S
  212. (skip hidden or system files).
  213.  
  214.  
  215. FILL.DOC                               5                           Apr 28, 1997
  216.  
  217. "/WIPE" says that if the destination drive has files on it, prompt the user for
  218. whether these files should be deleted or not.  Six sub-options show up in  this
  219. case:
  220.  
  221.     Do *NOT* delete the x file(s)    Don't delete anything
  222.     List file(s)                     List the files but don't delete any of
  223.                                      them.  The user will be reprompted for
  224.                                      these four options after pressing a key.
  225.     Select file(s) to delete         List the files and allow the user to
  226.                                      select any to be deleted.  Keys:
  227.                                         * Cursor keys -- move among list
  228.                                         * Space       -- select that file
  229.                                         * Ctrl-Enter  -- select all files
  230.                                         * Ctrl-bs     -- deselect all files
  231.                                         * Enter       -- process those tagged
  232.                                         * Esc         -- skip processing
  233.                                      After pressing Enter, the selected files
  234.                                      will be deleted.  You will then get the
  235.                                      standard four prompts again.
  236.     Delete all file(s)               Delete all files in the specified
  237.                                      directory.  Subdirectory files will not
  238.                                      be deleted.
  239.     Reformat the diskette            If your output drive is either A or B,
  240.                                      the program will shell to DOS and execute
  241.                                      a "FORMAT d:" command.  This (and the
  242.                                      next) sub-option will result in the
  243.                                      subdirectories being eliminated, something
  244.                                      which the prior sub-options don't do for
  245.                                      you.
  246.     Quick-reformat the diskette      If your output drive is either A or B and
  247.                                      you're running under DOS 5.0 or higher,
  248.                                      the program will shell to DOS and execute
  249.                                      a "FORMAT d: /Q" command.
  250.  
  251. Initially defaults to "/-WIPE".
  252.  
  253. "/-WIPE" reverses /WIPE.  Initially defaults to "/-WIPE".
  254.  
  255. "/MULTI" says to go to a second disk if all of the files can't fit on the first
  256. diskette.  Initially defaults to "/MULTI".
  257.  
  258. "/SINGLE" says process only one diskette at a time and to not  prompt  for  the
  259. next diskette once the first gets filled up.  Initially defaults to "/MULTI".
  260.  
  261.  
  262. FILL.DOC                               6                           Apr 28, 1997
  263.  
  264. "/SPLIT" says to split up large files which otherwise would not be able to  fit
  265. onto the output disk.  For example, /SPLIT is useful when you have a 1.8MB file
  266. that you're trying to copy or move to  a  1.2MB  or  1.44MB  diskette.   Unless
  267. /FORCE is specified, files are split only if an empty output diskette would not
  268. be able to support the file; FILL will not typically split up a 800KB file just
  269. because the 1.2MB output diskette only has 600KB free.   /SPLIT  must  be  used
  270. with a specific file request; not a wildcarded one.  Split files are given  the
  271. file extensions of .x01, .x02, etc (see /LETTER vs /-LETTER options  below  for
  272. explanation of the "x") until all necessary splitting is accomplished.  To  put
  273. them back together again, use the DOS  COPY  copy  with  the  /B  option.   For
  274. example:
  275.  
  276.         COPY TEST.Z01/B+TEST.Z02/B TEST.ZIP
  277.  
  278. If (and ONLY if) you use something like Norton's DIRSORT command so  the  files
  279. appear in  sequence  in  your  directory  (and  not  because  of  any  DIR  /ON
  280. specification!), you can also concatenate using wildcards:
  281.  
  282.         COPY TEST.Z0*/B TEST.ZIP          [ONLY IF PHYSICALLY IN CORRECT ORDER]
  283.  
  284. Do NOT try this unless you're sure though, okay?  Note that if you have  a  SET
  285. DIRCMD setting, the directory may look ordered when it's not.  Use DIR  /-O  to
  286. check if necessary.
  287.  
  288. "/-SPLIT" reverses "/SPLIT" and is initially the default.
  289.  
  290. "/FORCE" says to split up files when /SPLIT is used even if the file is smaller
  291. than the output disk would be.  So, if you have a 1.44MB diskette  and  a  600K
  292. file, /FORCE will allow it to be split.  This is not the  default  because  you
  293. typically do not want to split up every file; just the ones that are too big.
  294.  
  295. "/-FORCE" only allows files bigger than the output destination to be split  up.
  296. This is initially the default.
  297.  
  298. "/LETTER" says that when /SPLIT is specified,  use  the  first  letter  of  the
  299. original file extension when naming the split up file.  For  example,  TEMP.ZIP
  300. would become TEMP.Z01, TEMP.Z02, etc.  This does not affect files which do  not
  301. get split.  Initially defaults to "/LETTER".
  302.  
  303. "/-LETTER" says that split up file names  should  be  numeric  only.   TEMP.ZIP
  304. becomes TEMP.001, TEMP.002, etc.  This does not affect files which do  not  get
  305. split.  Initially defaults to "/LETTER".
  306.  
  307. "/LABEL=label" specifies the volume label to be written to the output disk.  By
  308. default, the label is not changed.   The  label  can  be  a  quoted  mixed-case
  309. string.  It can contain several replaceable lowercase only parameters:  "mm" is
  310. replaced with the two-digit month, "dd" is replaced  with  the  two-digit  day,
  311. "yy" is replaced with the two-digit year, and "n" or "nn" or "nnn" is  replaced
  312. by the sequence number of the disk.  All numeric fields are padded to the  left
  313. with zeroes as necessary.  If the current date is January 20, 1996:
  314.  
  315.         /LABEL="BKyymmdd nn"
  316.  
  317. will label the first first "BK960120 01", the second disk  "BK960120  02"  etc.
  318. Note that labels can be no longer than 11 characters in length.  All characters
  319. except the replaceable parameters will be translated to uppercase characters.
  320.  
  321.  
  322. FILL.DOC                               7                           Apr 28, 1997
  323.  
  324. "/START=n" specifies the first sequence number to use in place of "n", "nn", or
  325. "nnn" in the /LABEL parameter.  Defaults to "/START=1".
  326.  
  327. "/Frptfile" specifies the name of a status report file  to  be  created.   This
  328. file is a text file that reports on what's been processed by the  program.   If
  329. it exists already, the file is appended to, not overwritten.  A sample of  some
  330. lines from the file using the /S* option (which is not the default):
  331.  
  332.   FILL results for  /copy *.exe /ftest.txt /beep /wipe /s* /split
  333.   Being run on 01-20-1996 at 17:58:10
  334.  
  335.   Label        FileName    Date     Time                Size Operation
  336.  
  337.   TEST93 #01   AV.EXE       09/29/95 00:50:58          70,282 SKIP
  338.   TEST93 #01   BC.EXE       08/19/94 23:59:00         150,562 SKIP
  339.   TEST93 #01   BFIND.EXE    08/02/95 23:07:08          60,016 SKIP
  340.   TEST93 #01   VBDOS.EXE    08/19/94 23:59:00         555,520 COPY
  341.  
  342.   BRUCE        AV.EXE       09/29/93 00:50:58          70,282 SKIP
  343.   BRUCE        BC.EXE       08/19/92 23:59:00         150,562 SKIP
  344.   BRUCE        BFIND.EXE    08/02/93 23:07:08          60,016 SKIP
  345.  
  346. "/S+" specifies that the only files to be written to the status file are  those
  347. files that actually get copied/moved.  This is the default.
  348.  
  349. "/S-" specifies that the only files to be written to the status file are  those
  350. files that did not get copied/moved.  Since the skipping  is  determination  is
  351. done with each disk, the status file may show the same file name as "SKIP" over
  352. and over again.
  353.  
  354. "/S*" specifies that the status report should contain all files copied/moved as
  355. well as skipped.  This can be a huge report.
  356.  
  357. "/CONT" is used if you want the routine to continually check your floppy  drive
  358. to see when a new diskette has been put in and continue once it recognizes this
  359. has happened.  The only time you'd have to press a key is if you want  to  stop
  360. processing diskettes (in which case you'd press Escape).  The determination  of
  361. a new diskette is made by seeing if the  number  of  clusters  on  the  current
  362. diskette matches the number remaining on the old one.
  363.  
  364. "/-CONT" reverses "/CONT" and is initially the default.
  365.  
  366. "/TIME" says to show how much time it took for the  transfers,  showing  you  a
  367. bytes copied/moved per second.
  368.  
  369. "/-TIME" says to skip the bytes per second information.  This is initially  the
  370. default.
  371.  
  372.  
  373. FILL.DOC                               8                           Apr 28, 1997
  374.  
  375. "/BEEP" says to beep once the routine is done doing  its  thing  (a  high  tone
  376. followed by a low one).  It will also beep whenever it's time to stick in a new
  377. diskette (a low tone followed by a high one).  Initially defaults to "/BEEP".
  378.  
  379. "/-BEEP" says to not beep upon completion.  Initially defaults to "/BEEP".
  380.  
  381. "/Q" turns off the file-by-file status reporting.
  382.  
  383. "/LAST" says to indicate when you are starting the last disk  in  a  multi-disk
  384. set.  This doesn't apply to /SPLIT cases.  Some people consider  the  indicator
  385. to be rather unappealing on the screen so it's optional.  This is initially the
  386. default.
  387.  
  388. "/-LAST" turns off the last-disk indicator in a multi-disk set.
  389.  
  390. "/FAKE" turns off the actual copying of files.   It  basically  puts  you  into
  391. simulation mode so you can see what it would do, how many disks it would  take,
  392. et cetera.
  393.  
  394. "/-FAKE" reverses "/FAKE" and is initially the default.
  395.  
  396. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  397. defaults to "/COLOR".
  398.  
  399. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  400. initially the default.
  401.  
  402. "/Iinitfile" says to read an initialization file with the file name "initfile".
  403. The file specification *must* contain a period.  Initfiles are described in the
  404. BRUCEINI.DOC file.  Initially defaults to "/IFILL.INI".
  405.  
  406. "/-I" (or "/INULL") says to skip loading the initialization file.
  407.  
  408. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  409. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  410. more information.  This is initially the default.
  411.  
  412. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  413. Initially defaults to "/ENV".
  414.  
  415. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  416.  
  417.  
  418. Return codes:
  419.  
  420. FILL returns the following ERRORLEVEL codes:
  421.  
  422.         0 = no problems, all files copied
  423.         1 = no problems, but some files skipped since /-MULTI
  424.       251 = couldn't find @listfile file
  425.       252 = had DOS errors copying/moving the files (bad sectors found)
  426.       253 = had problems copying/moving the files
  427.       254 = no files found to copy/move
  428.       255 = syntax problems, or /? requested
  429.  
  430.  
  431.  
  432. FILL.DOC                               9                           Apr 28, 1997
  433.  
  434. Author:
  435.  
  436. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  437. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  438. program, no changes are made to the program or documentation,  and  it  is  not
  439. bundled with commercial programs or charged for separately.  People who need to
  440. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  441. Software" at the following address.
  442.  
  443. Additional information about this and other  Wayne  Software  programs  can  be
  444. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  445. The recent change history for this and the other programs is  provided  in  the
  446. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  447. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  448. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  449. naming the ZIP file (FILLymm.ZIP) that this program was included in.
  450.  
  451. Comments and suggestions can also be sent to:
  452.  
  453.                 Bruce Guthrie
  454.                 Wayne Software
  455.                 113 Sheffield St.
  456.                 Silver Spring, MD 20910
  457.  
  458.                 fax: (301) 588-8986
  459.                 e-mail: bguthrie@nmaa.org
  460.                 http://www.geocities.com/SiliconValley/Lakes/2414
  461.  
  462. Please provide an Internet e-mail address on all correspondence.
  463.  
  464. 
  465.